home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / slags2.z / slags2
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSLLLLAAAAGGGGSSSS2222((((3333SSSS))))                                                          SSSSLLLLAAAAGGGGSSSS2222((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SLAGS2 - compute 2-by-2 orthogonal matrices U, V and Q, such that if (
  10.      UPPER ) then  U'*A*Q = U'*( A1 A2 )*Q = ( x 0 ) ( 0 A3 ) ( x x ) and
  11.      V'*B*Q = V'*( B1 B2 )*Q = ( x 0 ) ( 0 B3 ) ( x x )  or if ( .NOT.UPPER )
  12.      then  U'*A*Q = U'*( A1 0 )*Q = ( x x ) ( A2 A3 ) ( 0 x ) and V'*B*Q =
  13.      V'*( B1 0 )*Q = ( x x ) ( B2 B3 ) ( 0 x )  The rows of the transformed A
  14.      and B are parallel, where  U = ( CSU SNU ), V = ( CSV SNV ), Q = ( CSQ
  15.      SNQ ) ( -SNU CSU ) ( -SNV CSV ) ( -SNQ CSQ )  Z' denotes the transpose of
  16.      Z
  17.  
  18. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  19.      SUBROUTINE SLAGS2( UPPER, A1, A2, A3, B1, B2, B3, CSU, SNU, CSV, SNV,
  20.                         CSQ, SNQ )
  21.  
  22.          LOGICAL        UPPER
  23.  
  24.          REAL           A1, A2, A3, B1, B2, B3, CSQ, CSU, CSV, SNQ, SNU, SNV
  25.  
  26. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  27.      These routines are part of the SCSL Scientific Library and can be loaded
  28.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  29.      directs the linker to use the multi-processor version of the library.
  30.  
  31.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  32.      4 bytes (32 bits). Another version of SCSL is available in which integers
  33.      are 8 bytes (64 bits).  This version allows the user access to larger
  34.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  35.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  36.      only one of the two versions; 4-byte integer and 8-byte integer library
  37.      calls cannot be mixed.
  38.  
  39. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  40.      SLAGS2 computes 2-by-2 orthogonal matrices U, V and Q, such that if (
  41.      UPPER ) then U'*A*Q = U'*( A1 A2 )*Q = ( x 0 ) ( 0 A3 ) ( x x ) and
  42.      V'*B*Q = V'*( B1 B2 )*Q = ( x 0 ) ( 0 B3 ) ( x x ) or if ( .NOT.UPPER )
  43.      then U'*A*Q = U'*( A1 0 )*Q = ( x x ) ( A2 A3 ) ( 0 x ) and V'*B*Q = V'*(
  44.      B1 0 )*Q = ( x x ) ( B2 B3 ) ( 0 x ) The rows of the transformed A and B
  45.      are parallel, where U = ( CSU SNU ), V = ( CSV SNV ), Q = ( CSQ SNQ ) (
  46.      -SNU CSU ) ( -SNV CSV ) ( -SNQ CSQ ) Z' denotes the transpose of Z.
  47.  
  48.  
  49. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  50.      UPPER   (input) LOGICAL
  51.              = .TRUE.: the input matrices A and B are upper triangular.
  52.              = .FALSE.: the input matrices A and B are lower triangular.
  53.  
  54.      A1      (input) REAL
  55.              A2      (input) REAL A3      (input) REAL On entry, A1, A2 and A3
  56.              are elements of the input 2-by-2 upper (lower) triangular matrix
  57.              A.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSLLLLAAAAGGGGSSSS2222((((3333SSSS))))                                                          SSSSLLLLAAAAGGGGSSSS2222((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      B1      (input) REAL
  75.              B2      (input) REAL B3      (input) REAL On entry, B1, B2 and B3
  76.              are elements of the input 2-by-2 upper (lower) triangular matrix
  77.              B.
  78.  
  79.      CSU     (output) REAL
  80.              SNU     (output) REAL The desired orthogonal matrix U.
  81.  
  82.      CSV     (output) REAL
  83.              SNV     (output) REAL The desired orthogonal matrix V.
  84.  
  85.      CSQ     (output) REAL
  86.              SNQ     (output) REAL The desired orthogonal matrix Q.
  87.  
  88. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  90.  
  91.      This man page is available only online.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.